home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d20
/
renamrc1.arc
/
RENAMARC.DOC
< prev
Wrap
Text File
|
1991-03-12
|
5KB
|
103 lines
RENAMARC.COM (C)1991 By Maurice H. Warnon, SysOp of the Third Ring RBBS.
FidoNet Address: 1:272/30.0
RENAMARC.COM can be used by anyone, but is not free. It can be
distributed and copied as long as this documentation file
remains with it, and its content is unchanged.
It is offered under the "DinnerWare" concept. This means that if you intend
to use this utility, you're obligated to take your spouse and/or friend out
for good dinner. Not for a fast food dinner: I worked too hard on this
to get a cheap reward!
WARRANTY: The only warranty I can give you is that RENAMARC.COM
will occupy some space on your disk.
RENAMARC.COM is a utility born, as many others, from frustration and despair.
The Third Ring RBBS bearly survived a major desaster in november 1990, when
my house was hit by lightening.
The bulletin board was running since 1984 without interruption. It contained
thousands of files and programs. Most of those safely backed up on diskettes
and tapes. The major problem was to locate and restore the user files and
messages. Back up copies existed, but the most recent was a month old.
The reason was that I didn't have a very simple procedure to identify backup
files automatically. This program has for primary purpose the creation of
backup files erasing themselves automatically according to a daily, weekly,
monthly or yearly schedule. A simple copy renamarc command issued from a
.BAT file, takes care of the cyclic backup business...
This utility is RENAMING (not copying) any file indicated in the first
parameter with a new file extension determined by the current setting of
the resident clock on the Personal Computer.
As an example, if files need to be backed up daily, but kept only for a week,
the /S option is a good solution. The file will be updated on Monday with the
.MON extension, Tuesday with the .TUE extenstion, and so on...
The following week, the .MON file will be replaced by the new .MON file,
without affecting the other days: there will never be more than seven copies
of the backed up file. The same logic applies for the other options offered
by this utility.
Format: RENAMARC <Filename.Ext> <Dest> </n> </v>
<Filename.Ext> is the name of the file to be renamed by RENAMARC.COM.
<Dest> is a name (up to 8 chars) replacing <Filename>.
If <Filename> is to remain unchanged, the <Dest> parameter
is to be ignored, or contain the EXACT same information as
the <Filename> parameter. A file cannot be renamed and moved
simultaneously into another drive or into another Directory.
The command will work with another Drive or
Directory, if the renamed filed remains if the same directory
as indicated in the <Filename> parameter.
Eg: on 01/01/1991: RENAMARC TEST.TST MYFILE /X
will rename TEST.TST as MYFILE.JAN
on 03/12/1991: RENAMARC TEST.TST /J
will rename TEST.TST as TEST.071
on 12/31/1991: RENAMARC D:\YEAREND\TEST.TST /Y
will rename TEST.TST as TEST.Y91 on
the D: drive, and the \YEAREND Directory, but the
TEST.Y91 can only be located in the same location.
</n> is the parameter indicating the choice of extension.
The choices are as follows:
Values of /n -> /J .Ext = .JJJ Julian Date 001 -> 366 (3 digits)
/Y .Ext = .Yyy Char Y + YEAR Y00 -> Y99 (2 digits)
/M .Ext = .Mmm Char M + MONTH M01 -> M12 (2 digits)
/H .Ext = .Hhh Char H + HOUR H00 -> H23 (2 digits)
/D .Ext = .Ddd Char D + DAY D01 -> D31 (2 digits)
/X .Ext = .MMM MONTH NAME JAN -> DEC (3 alphas)
/S .Ext = .DDD DAY NAME MON -> SUN (3 alphas)
</v> is the parameter allowing file security control:
/V is the VERIFY option. It will detect if the new
name already exists, and provides for operator's
intervention by exiting with an errorlevel.
/O will write over any file of the same name.
ERROR LEVELS: The use of DOS Errorlevels allows RENAMARC.COM to
be used in .BAT files with an adequate level of ease, Checking
the ERRORLEVEL's in the .BAT files will allow to automate the
process of archiving with sufficient control over unexpected
situations. Detection of dupplicated, inexisting, or erroneous files
can be taken care of. The files are renamed only when the
program exits with the Errorlevel set to 0 (Zero).
Error Level
in RENAMARC Description
0 File renamed. Normal exit.
1 No parameter found.
2 The file to be renamed doesn't exist.
3 When attempting to rename, a file was
found with the same name.
(For option VERIFY [/V] only).
8 An I/O error occured when writing
over an existing file (Option /O only).
9 An I/O error occured when renaming the file.
Please report oddities and suggestions to:
Maurice H. Warnon,
The Third Ring RBBS
FidoNet: 1:272/30.0
(914) 496 9259.